home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / compress / fbud310.zip / FBUDDY.DOC next >
Text File  |  1993-11-25  |  103KB  |  2,298 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                   F i l e B U D D Y (tm)
  10.  
  11.  
  12.  
  13.                                More Than Just A File Viewer
  14.  
  15.                                        Version 3.10
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                        USER'S GUIDE
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                            Copyright (c) 1992-1993 Lenard Dean
  49.                                    All Rights Reserved
  50.  
  51.                                     November 25, 1993
  52.             Warranty And License
  53.             ====================
  54.  
  55.             This software and accompanying documentation is provided AS-IS.
  56.             Even though the author has tested this software and reviewed its
  57.             documentation, NO WARRANTY OR REPRESENTATION RELATING TO IT IS
  58.             MADE, WHETHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
  59.             LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR
  60.             ANY PURPOSE.  THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT
  61.             OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS SOFTWARE,
  62.             even if advised of the possibility of such damages.  THE USER
  63.             BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THIS
  64.             SOFTWARE.  IN NO EVENT SHALL ANY DAMAGES EXCEED THE PRICE PAID
  65.             FOR THE LICENSE TO USE THIS SOFTWARE REGARDLESS OF THE FORM OF
  66.             CLAIM.
  67.  
  68.             You ARE encouraged to pass along copies of FileBUDDY to friends
  69.             and favorite BBSs.  Please keep all the files together.
  70.  
  71.  
  72.             Ombudsman (ASP)
  73.             ===============
  74.  
  75.             This program is produced by           _______
  76.             a member of the Association      ____|__     |                (R)
  77.             of Shareware Professionals    --|       |    |-------------------
  78.             (ASP).  ASP wants to make       |   ____|__  |  Association of
  79.             sure that the shareware         |  |       |_|  Shareware
  80.             principle works for you.        |__|   o   |    Professionals
  81.             If you are unable to resolve  -----|   |   |---------------------
  82.             a shareware-related problem        |___|___|    MEMBER
  83.             with an ASP member by
  84.             contacting the member directly, ASP may be able to help.  The ASP
  85.             Ombudsman can help you resolve a dispute or problem with an ASP
  86.             member, but does not provide technical support for members'
  87.             products.  Please write to the ASP Ombudsman at 545 Grover Road,
  88.             Muskegon, MI 49442 or send a CompuServe message via CompuServe
  89.             Mail to ASP Ombudsman 70007,3536.
  90.  
  91.  
  92.             Trademarks
  93.             ==========
  94.  
  95.             Product names mentioned in this documentation are trademarks or
  96.             registered trademarks of their respective owners.  FileBUDDY is a
  97.             trademark of Lenard Dean.
  98.             Table Of Contents
  99.             =================
  100.  
  101.  
  102.  
  103.             Introduction ................................................. 1
  104.  
  105.             Getting Started .............................................. 2
  106.  
  107.             Using FileBUDDY .............................................. 3
  108.  
  109.             Menus And Messages ........................................... 5
  110.  
  111.             Editing Files ................................................ 6
  112.  
  113.             Searching Text ............................................... 6
  114.  
  115.             Capturing Text ............................................... 7
  116.  
  117.             Printing Text Files .......................................... 7
  118.  
  119.             Archiving And Extracting/Deleting Archived Files ............. 11
  120.  
  121.             Viewing, Editing, Creating, And Printing dBase Files ......... 12
  122.  
  123.             Viewing, Processing, Saving, And Printing Images ............. 16
  124.  
  125.             Customizing FileBUDDY ........................................ 24
  126.  
  127.             Contacting The Author......................................... 34
  128.  
  129.             APPENDIX A: Registration Information ......................... 35
  130.  
  131.             APPENDIX B: Color Chart ...................................... 36
  132.  
  133.             APPENDIX C: Questions And Answers ............................ 37
  134.             Introduction
  135.             ============
  136.  
  137.             FileBUDDY is a simple but unique file viewer that lets you view
  138.             and manipulate various file formats.  If you do a lot of
  139.             "BBSing", you should find FileBUDDY very handy.  Here's a brief
  140.             overview:
  141.  
  142.                   * FileBUDDY can view any size file, whether the file
  143.                     is 1 byte or 1 gigabyte in length.
  144.  
  145.                   * FileBUDDY lets you capture text to a file by taking
  146.                     a "snapshot" of it.  When a snapshot is taken, it
  147.                     is done "intelligently".  That is, overlapping text
  148.                     in consecutive snapshots will not be duplicated in
  149.                     the destination file.
  150.  
  151.                   * FileBUDDY incorporates a printer setup facility
  152.                     which allows you configure any printer when printing
  153.                     text files.
  154.  
  155.                   * FileBUDDY views dBASE files.  It can also edit,
  156.                     add, delete, undelete records, create and "pack" dBASE
  157.                     files, and generate "quick & dirty" reports.
  158.  
  159.                   * FileBUDDY views archive files.  If the proper archiver
  160.                     is available, ARC, ARJ, LZH, PAK, ZIP, and associated
  161.                     self-extracting files can be viewed down to 5 levels
  162.                     deep.  Support for archiving files and extracting/
  163.                     deleting archived files is also provided.
  164.  
  165.                   * FileBUDDY displays image files.  If a VGA or a SVGA
  166.                     (with an ATI, Paradise, Trident, Tseng, Video 7, or
  167.                     "VESA" chipset) video card is detected, BIF (binary),
  168.                     BMP, GIF, JPEG, PCX, TARGA, and TIF image files can be
  169.                     viewed.  Video cards with 32k, 64k, or 16m modes are
  170.                     supported when displaying 24-bit images.  If extended or
  171.                     expanded memory is available, it will be used to hold the
  172.                     image.  Images too large to fit the best video mode can
  173.                     be "navigated" using the cursor keys or resized to fit
  174.                     the best video mode.  Other image handling capabilities
  175.                     include processing, cropping, saving across image formats
  176.                     (including to EPS), and "slide-show" viewing.  Images may
  177.                     be printed to HP LaserJet, HP DeskJet 500c, Epson 24-pin
  178.                     dot-matrix, or compatible printers with or without a
  179.                     user-defined border.  (Printing to file is also
  180.                     supported.)  Printing resolution up to 1200 DPI is
  181.                     supported for printers that support it.
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.                                                                             1
  191.             Getting Started
  192.             ===============
  193.  
  194.             To use FileBUDDY, you'll need the following minimum hardware:
  195.  
  196.                   * Any IBM-compatible computer
  197.                   * 640K bytes of conventional memory (and 2MB of extended
  198.                     or expanded memory for serious image viewing/processing)
  199.                   * hard drive or two floppy drives
  200.                   * monochrome or color monitor
  201.                   * VGA or SVGA video card (to view image files) 
  202.                   * printer (optional) 
  203.                   * mouse (optional)
  204.  
  205.             You'll also need the software below:
  206.  
  207.                   * MS-DOS 3.00 or later
  208.                   * text editor or word-processor that can save in ASCII
  209.  
  210.             Program files supplied in the self-extracting file are:
  211.  
  212.                   FBUDDY.EXE      FileBUDDY Program
  213.                   FBUDDYI.EXE     FileBUDDY Image Viewer Program
  214.                   FBUDDY.DOC      FileBUDDY Documentation
  215.                   FBUDDY.PIF      Windows PIF File
  216.                   FBUDDY.ICO      Windows Icon File
  217.                   SAMPLE.INI      Sample Initialization File
  218.                   SAMPLE.FRM      Sample dBASE Print Form
  219.                   README          Important Information
  220.                   REGISTER        Registration Form
  221.                   WHATSNEW.DOC    What's New Information
  222.                   SYSOP.DOC       Sysop Information
  223.                   FILE_ID.DIZ     BBS Description Program File
  224.                   INSTALL.EXE     Installation Program
  225.  
  226.             The quickest way to install or upgrade FileBUDDY is to run
  227.             INSTALL.EXE.  When the installation program is run, you will be
  228.             asked about the following:
  229.  
  230.                   1) the directory to install FileBUDDY in.  The default is
  231.                      C:\FBUDDY.
  232.  
  233.                   2) whether you want FileBUDDY's location added to the
  234.                      PATH statement in AUTOEXEC.BAT.  (If it already exists, 
  235.                      it will not be added.)  If so, the original AUTOEXEC.BAT
  236.                      will be saved as AUTOEXEC.OLD.
  237.  
  238.                   3) if you have a monochrome monitor with a color card.  
  239.                      If so, you should select this option to force a "black
  240.                      and white" color setup.
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.                                                                             2
  248.             Check boxes are marked by clicking with the left mouse button.
  249.             To use the keyboard, select the TAB key to move between check
  250.             boxes and the SPACEBAR to mark them.  When you are ready to
  251.             install, press ENTER.
  252.  
  253.             If you prefer to install FileBUDDY manually, copy all of
  254.             FileBUDDY's files to the destination directory.  If you are
  255.             upgrading from a previous version, please refer to the README
  256.             file.  Otherwise, type the following from FileBUDDY's directory:
  257.  
  258.                   fbuddy
  259.  
  260.             If you're installing on a system with a monochrome monitor and
  261.             color card, use the "/bw" switch to force a "black and white"
  262.             color setup:
  263.  
  264.                   fbuddy /bw
  265.  
  266.             Executing FileBUDDY for the first time will create the
  267.             initialization file called FBUDDY.INI.  (For more information
  268.             about this file, refer to the section "Customizing FileBUDDY".)
  269.  
  270.  
  271.             Using FileBUDDY
  272.             ===============
  273.  
  274.             There are a couple of ways to view a file.  The first method is
  275.             to type the filename on the command line:
  276.  
  277.                   fbuddy filename
  278.  
  279.             The second method is to run FileBUDDY by itself:
  280.  
  281.                   fbuddy
  282.  
  283.             In the latter method, files are selected from FileBUDDY's file
  284.             directory.  To scroll through the files, press the left mouse
  285.             button and move the mouse cursor past the top or bottom of the
  286.             file directory box.  If you prefer to use the keyboard, the
  287.             CURSOR, HOME, END, PGDN, and PGUP keys are supported.  Files are
  288.             shown in lower case and subdirectories in upper case.  Select
  289.             ".." to change to the parent directory.  Press ENTER or double
  290.             click with the left mouse button to select a file to view.
  291.  
  292.             You may note a character between the filename and its extension
  293.             when the DOS file directory is displayed.  The small "dot"
  294.             character signifies the file is read-only whereas the "textured
  295.             square" character signifies a hidden and/or a system file.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.                                                                             3
  305.             To navigate through a text file, the following keys are
  306.             recognized:
  307.  
  308.                   HOME               Positions the view window at the
  309.                                      beginning of the file.
  310.  
  311.                   END                Positions the view window at the end
  312.                                      of the file.
  313.              
  314.                   CTRL+HOME          Positions the view window at column one.
  315.  
  316.                   CTRL+END           Positions the view window at the end
  317.                                      of the longest line in the current
  318.                                      view window.
  319.  
  320.                   UP CURSOR          Scrolls the view window up one line.
  321.  
  322.                   DOWN CURSOR        Scrolls the view window down one line.
  323.  
  324.                   LEFT CURSOR        Scrolls the view window one character
  325.                                      to the left.
  326.  
  327.                   RIGHT CURSOR       Scrolls the view window one character
  328.                                      to the right.
  329.  
  330.                   PGUP               Pages the view window up.
  331.  
  332.                   PGDN               Pages the view window down.
  333.  
  334.                   CTRL+LEFT CURSOR   Pages the view window to the left.
  335.  
  336.                   CTRL+RIGHT CURSOR  Pages the view window to the right.
  337.  
  338.             To scroll using the mouse, press the left button and move the
  339.             mouse in the direction you want to scroll.  Clicking on the
  340.             border around the text lets you scroll vertically a line at a
  341.             time or horizontally a character at a time.  Word-wrap mode is
  342.             invoked using the BACKSPACE key.  Whenever word-wrapping is
  343.             selected (or unselected), you will be positioned at the beginning
  344.             of the file.
  345.  
  346.             To view another file, press ESC (or CTRL+O).  A file format that
  347.             is not supported by FileBUDDY can be viewed with an external
  348.             program by pressing CTRL+A over the file.  (Make sure to define
  349.             the 'Associate' parameter in FBUDDY.INI.  See "Customizing
  350.             FileBUDDY" under the "[DEFINE]" heading for more information.)
  351.             You can delete a file from the file directory pressing the DELETE
  352.             key on the file.  To delete a group of files, tag the files first
  353.             with the SPACEBAR, CTRL+[LEFT MOUSE BUTTON], or CTRL+SPACEBAR
  354.             keys.  The file directory can be refreshed anytime using CTRL+R.
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.                                                                             4
  362.             Menus And Messages
  363.             ==================
  364.  
  365.             Menus and messages are displayed at the bottom of the screen.
  366.             There are three menus in FileBUDDY: the View Menu, the Main Menu,
  367.             and the Utilities Menu.  Below is a breakdown of commands under
  368.             each menu:
  369.  
  370.                   Located in the View Menu:
  371.  
  372.                   [M]ain              Selects the Main Menu.  (Pressing the
  373.                                       right mouse button does the same 
  374.                                       thing.)
  375.  
  376.                   Located in the Main Menu:
  377.  
  378.                   [O]pen              Displays the DOS file directory to open
  379.                                       a file for viewing.  (Pressing ESC from
  380.                                       the View Menu does the same thing.)
  381.  
  382.                   [E]dit              Edits the file being viewed.
  383.  
  384.                   [F]ind              Searches for a word or phrase in a
  385.                                       file.
  386.  
  387.                   [C]apture           Toggles Capture mode ON or OFF.
  388.  
  389.                   [P]rint             Prints the file being viewed.
  390.              
  391.                   Util[s]             Selects the Utilities Menu.
  392.  
  393.                   [D]OS               Shells out to DOS.
  394.  
  395.                   [Q]uit              Quits FileBUDDY.  (Pressing ESC twice
  396.                                       or pressing the middle mouse button on
  397.                                       a 3-button mouse does the same thing.)
  398.  
  399.                   Located in the Utilities Menu:
  400.  
  401.                   Confi[g]Prn         Displays the printer configuration
  402.                                       list.
  403.  
  404.                   Se[t]ConfigDefault  Assigns a printer configuration to
  405.                                       DEFAULT.
  406.  
  407.                   CreateD[B]F         Creates a dBASE file structure.
  408.  
  409.                   Pac[k]DBF           Packs a dBASE file
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.                                                                             5
  419.             All commands in each menu can be accessed three ways:
  420.  
  421.                   1. Pressing the command's highlighted letter.
  422.                   2. Clicking on the command name with the mouse.
  423.                   3. Pressing CTRL+[highlighted letter].
  424.  
  425.             Use the ESC key to cancel commands or messages displayed.  Note
  426.             that FileBUDDY interprets the right mouse button as the ESC key.
  427.             The only time this is not so is when the View Menu is displayed.
  428.             (It toggles the Main Menu.)
  429.  
  430.  
  431.             Editing Files
  432.             =============
  433.  
  434.             Text files may be edited using CTRL+E.  FileBUDDY does not
  435.             incorporate an editor so one must be defined in FBUDDY.INI.
  436.             (Refer to the 'Editor' parameter description in "Customizing
  437.             FileBUDDY" for more information).  When attempting to edit very
  438.             large files, remember that your editor may not be able to edit
  439.             them.  No harm is done if you try to edit such a file as the
  440.             editor will just abort and return you to FileBUDDY.
  441.  
  442.             Archived text files may also be edited.  Edit them like a normal
  443.             file.  If the text file is modified, FileBUDDY will prompt you if
  444.             you want to update the archive file.  If so, press "Y" or "y" or
  445.             the ENTER key.  If not, press "N" or "n" (or any other key).
  446.             When an archive file is updated, the "xxxINFO" file (the first
  447.             file in the archive directory) is not updated.  It can, however,
  448.             be refreshed with CTRL+R.
  449.  
  450.             If you edit a text file that originates from an embedded archive
  451.             or a self-extracting archive, an error message will be displayed
  452.             when you try to update the archive.  If you need to edit a copy
  453.             of such a file, make sure to save the modified file to your work
  454.             directory BEFORE exiting the text editor (or word-processor) or
  455.             you will lose all your changes.
  456.  
  457.  
  458.             Searching Text
  459.             ==============
  460.  
  461.             The Find command, CTRL+F, lets you search text files with any
  462.             "key".  Search keys can be based on a character, word, or phase.
  463.             Multiple key searches are performed using the comma as the key
  464.             separator.  For example:
  465.  
  466.                   Find: good,better,best
  467.  
  468.             Although not shown, it's okay to have blank spaces before and
  469.             after the commas.  Please note that you cannot specify a comma as
  470.             a key in a multiple key search since the comma is used as the key
  471.             separator.
  472.  
  473.  
  474.  
  475.                                                                             6
  476.             To treat a key as a "whole word" during a search, enclose it in
  477.             double angle brackets like in the following example:
  478.  
  479.                   Find: good,better,<<best>>
  480.  
  481.             All searches start from the first line in the view window.  If
  482.             you want to start your search from the beginning of the file,
  483.             make sure to press HOME before entering your search criteria.
  484.             When multiple key searches are performed, each line is scanned
  485.             with all keys.
  486.  
  487.             Searches are not case sensitive so any occurrence of a key found
  488.             is highlighted.  To continue a search, press TAB.  New search
  489.             criteria are entered by pressing CTRL+F again.  Previous search
  490.             criteria may be cleared with SHIFT+DELETE.  (The contents can be
  491.             restored by pressing SHIFT+INSERT.)
  492.  
  493.  
  494.             Capturing Text
  495.             ==============
  496.  
  497.             Capture mode is invoked with CTRL+C.  FileBUDDY will prompt you
  498.             for the name of the destination file for the text to be saved to.
  499.             The default filename is FBUDDY.CAP with the path being what was
  500.             specified in FBUDDY.INI under the 'WorkDir' parameter.  If you
  501.             want to modify this, press SHIFT+DELETE to clear the filename and
  502.             enter a new one.  Any text saved to an existing capture file is
  503.             appended.
  504.  
  505.             Snapshots are taken using the ENTER key.  A large block of text
  506.             can be captured by pressing the PGDN and ENTER keys alternately.
  507.             If you prefer to scroll using the mouse or cursor keys, don't
  508.             worry about overlapping text between consecutive snapshots as
  509.             they will not be duplicated in the capture file.  Snapshots not
  510.             consecutively taken are separated by a solid bar line.  If you
  511.             are viewing a dBASE file and want to capture a record that has
  512.             more than 22 fields, you DO NOT need to scroll down to capture
  513.             the fields not shown.  Pressing ENTER once is enough.
  514.  
  515.             Capture mode is turned off by invoking CTRL+C again.  It's not
  516.             necessary to turn capture mode off before exiting FileBUDDY as
  517.             it's done automatically.
  518.  
  519.  
  520.             Printing Files
  521.             ==============
  522.  
  523.             Before printing a file, you will need to configure your printer.
  524.             Press CTRL+G and select the desired configuration from the menu
  525.             list.  If you are just starting out, the only names you will see
  526.             are DEFAULT and NOSETUP.  The configuration name DEFAULT always
  527.             appears at the top of the list and is used to store a printer
  528.             configuration that you want FileBUDDY to use by default.  To
  529.             assign DEFAULT to a printer configuration, press CTRL+T.  When
  530.  
  531.  
  532.                                                                             7
  533.             FileBUDDY is first installed, the NOSETUP printer configuration
  534.             is assigned to DEFAULT.  NOSETUP is a "dummy" configuration that
  535.             is used to print text files already formatted.  Since NOSETUP
  536.             contains no setup codes, your printer is not configured in any
  537.             way.  NOSETUP merely "opens" the printer port (ie. LPT1, LPT2, or
  538.             LPT3) for printing.
  539.  
  540.             To configure your printer to print unformatted text files, you'll
  541.             need to create your own printer configurations and add them to
  542.             the FBUDDY.INI file.  The FBUDDY.INI file is modified using a
  543.             text editor or word-processor.  Make sure when you resave
  544.             FBUDDY.INI to save it in ASCII format.  Most text editors will do
  545.             this but if you are using a word-processor this will not
  546.             necessarily be true.
  547.  
  548.             Each printer configuration is distinguished by a unique name and
  549.             preceded by the "@" character.  When creating a name, any
  550.             combination of upper or lower case letters may be used.  The name
  551.             should be no longer than 12 characters in length.  For example:
  552.  
  553.                   @CONDENSED
  554.  
  555.             To setup a printer connected to LPT2, LPT3, or PRN insert a colon
  556.             after the name and type "LPT2", "LPT3", or "PRN" like:
  557.  
  558.                   @CONDENSED:LPT2
  559.  
  560.             For each printer command line, type some descriptive text of any
  561.             length followed by the "=" character.  Place the appropriate
  562.             control codes after the "=" character, separating each value with
  563.             a comma.  (A list of printer commands and formatting codes for
  564.             your printer can normally be found in the printer user's manual.)
  565.             FileBUDDY recognizes printer codes in decimal or hexadecimal
  566.             format.  If you decide to use hexadecimal codes, make sure to
  567.             precede each value with "&H".  Here is an example of a printer
  568.             configuration:
  569.  
  570.                   @CONDENSED:LPT2
  571.                   Master Reset  =27,64
  572.                   Condensed ON  =15
  573.                   Left Margin   =&H1B,&H6C,&H07
  574.                   Right Margin   27,81,127
  575.                   Text          ="Condensed Mode"
  576.                   Blank Line    =""
  577.  
  578.             Notice the last two lines.  If you need to send some text to the
  579.             printer before printing a file, that is how it's done.  You can
  580.             have up to 10 of these lines.  Also, note that spaces (or TABs)
  581.             may be inserted between the text and "=" or between "=" and the
  582.             first control code value.  If you need to temporarily prevent a
  583.             line from being processed, leave out the "=" as shown in the
  584.             example.
  585.  
  586.  
  587.  
  588.  
  589.                                                                             8
  590.             Keep your printer configurations easy to read by separating them
  591.             with a blank line.  Below is a copy of SAMPLE.INI showing what a
  592.             typical FBUDDY.INI file may look like:
  593.  
  594.                   [INITIALIZATION]
  595.                   Version=3.10
  596.                   MouseSen=12
  597.                   MouseSS=12
  598.                   MouseLBSS=60
  599.                   TabSpaces=8
  600.                   ExitOnEsc=YES
  601.                   FileSort=2
  602.                   PrnConfigSort=1
  603.                   BeepSound=6
  604.                   Shadow=YES
  605.                   Border=1
  606.                   LBBorder=3
  607.                   HelpBorder=2
  608.                   TextColor=7
  609.                   LBTextColor=7
  610.                   BorderColor=14
  611.                   LBBorderColor=14
  612.                   HelpTextColor=7
  613.                   HelpBorderColor=10
  614.                   HMBarColor=27
  615.                   HiLiteColor=30
  616.                   FileNameColor=31
  617.                   LBCsrColor=48
  618.                   MouseCsrColor=71
  619.  
  620.                   [SWAP]
  621.                   SwapWhenEditor=3
  622.                   SwapWhenDOS=3
  623.                   SwapWhenAssociate=1
  624.                   SwapWhenImage=1
  625.  
  626.                   [DEFINE]
  627.                   OtherArcExt=LZH:QWK,ARJ:SDN,ZIP:BAK
  628.                   FileEOLChar=PLX:10,DAT:227
  629.                   Associate1=WKS:c:\utils\spread.exe
  630.  
  631.                   [PATHS]
  632.                   WorkDir=c:\workdir
  633.                   Editor=c:\dos\edit.com
  634.                   ARC=c:\utils\arc.exe
  635.                   ARJ=c:\utils\arj.exe
  636.                   LZH=c:\utils\lha.exe
  637.                   PAK=c:\utils\pak.exe
  638.                   ZIP=c:\utils\pkzip.exe
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.                                                                             9
  647.                   [ARCHIVE]
  648.                   Compression=1
  649.                   SFXModel=2
  650.                   ResetArchivePW=YES
  651.  
  652.                   [DBF]
  653.                   DBFPackBackup=1
  654.  
  655.                   [IMAGE]
  656.                   SlideShowPause=10
  657.                   Image1BitFormat=2
  658.                   ImageRestore=0
  659.                   ImageCsrRes=100
  660.                   ImageLPT=1
  661.                   ImageDPT=300
  662.                   ImageSize=7500
  663.                   ImageRow=0
  664.                   ImageColumn=400
  665.                   ImagePrtMode=0
  666.                   ImageBorder=NO
  667.  
  668.                   [PRINTER]
  669.                   PrnSetupDefault=NLQ
  670.  
  671.                   @NOSETUP
  672.  
  673.                   @NLQ
  674.                   Master Reset   =27,64
  675.                   Select NLQ     =27,120,1
  676.                   Roman Font     =27,107,0
  677.                   Left Margin    =27,108,5
  678.                   Bottom Margin  =27,78,7
  679.  
  680.                   @CONDENSED:LPT2
  681.                   Master Reset   =27,64
  682.                   Condensed ON   =15
  683.                   Left Margin    =27,108,7
  684.                   Right Margin   =27,81,127
  685.                   Bottom Margin  =27,78,7
  686.                   Tab Increments =27,101,0,2
  687.                   Text           ="Condensed Mode"
  688.                   Blank Line     =""
  689.  
  690.                   @GRAPHICS:LPT3
  691.                   Master Reset   =27,64
  692.                   Graphic Mode   =27,116,1,27,6
  693.                   Left Margin    =27,108,5
  694.  
  695.             Note how each printer configuration starts with 'Master Reset'.
  696.             This clears any previous settings in the printer to the setting
  697.             set by the printer's "dip switches".  This is the same thing as
  698.             turning your printer off and then back on again.  Keep in mind
  699.             that reset codes vary from printer to printer so the ones used in
  700.             the example may not apply to you.
  701.  
  702.  
  703.                                                                             10
  704.             Archiving And Extracting/Deleting Archived Files
  705.             ================================================
  706.  
  707.             Assuming you have defined the archiver(s) you plan to use (if
  708.             not, refer to "Customizing FileBUDDY" under the [PATHS] parameter
  709.             heading), FileBUDDY allows you to archive files from the DOS file
  710.             directory using the following keys:
  711.  
  712.                   F2              Create a ARC archive.
  713.                   F3              Create a ARJ archive.
  714.                   F4              Create a LZH archive.
  715.                   F5              Create a PAK archive.
  716.                   F6              Create a ZIP archive.
  717.                   CTRL+F2         Create a self-extracting ARC archive.
  718.                   CTRL+F3         Create a self-extracting ARJ archive.
  719.                   CTRL+F4         Create a self-extracting LZH archive.
  720.                   CTRL+F5         Create a self-extracting PAK archive.
  721.                   CTRL+F6         Create a self-extracting ZIP archive.
  722.  
  723.             When archiving, the first thing you'll be prompted for is an
  724.             archive name (file extension is not necessary).  If the archive
  725.             file already exists, the selected files are added to it.  You
  726.             will also be asked for a "comment" file.  A comment file is
  727.             simply a short ASCII file you create to describe the archive.
  728.             When creating the comment file, leave one or two blank lines at
  729.             the beginning and the end of the file so that the comment "block"
  730.             will standout when it is displayed.  If you don't want to add
  731.             comments to the archive, leave the prompt blank and press ENTER.
  732.             (You can always enclose one later when you add other files to the
  733.             archive.)  Lastly, you'll be asked whether you want the original
  734.             files deleted after they've been archived.  If you answer "yes"
  735.             and an error occurs during the archiving process, the files will
  736.             not be deleted.
  737.  
  738.             Multiple files are archived by tagging the files with the
  739.             SPACEBAR or CTRL+[LEFT MOUSE BUTTON] (double-click) keys.  To
  740.             select all the files in the file directory, press CTRL+SPACEBAR.
  741.             (Tagged files can be untagged by pressing the keys again.)  Once
  742.             the files have been tagged, select the appropriate function key
  743.             to archive them.
  744.  
  745.             If you wish to password-protect the archive file, enter your
  746.             password with CTRL+Z before you start the archiving.  Also,
  747.             please note when archiving that FileBUDDY relies on a few
  748.             parameters in FBUDDY.INI.  For more information about these
  749.             parameters, please refer to "Customizing FileBUDDY" under the
  750.             [ARCHIVE] parameter heading.
  751.  
  752.             To extract an archived file from the archive directory, press
  753.             CTRL+U on the file to extract.  You'll be prompted to enter a
  754.             work directory path.  Press ENTER to accept the default path (it
  755.             will be the one you specified under 'WorkDir' in FBUDDY.INI) or
  756.             enter a new one.  To extract the file to the current DOS
  757.  
  758.  
  759.                                                                             11
  760.             directory, clear the path displayed at the prompt with
  761.             SHIFT+DELETE and press ENTER.  If you don't want to be prompted
  762.             for a path when extracting a file, press CTRL+ENTER.  The file
  763.             will be extracted to the directory specified in 'WorkDir' (unless
  764.             of course it was modified earlier when you extracted a file with
  765.             CTRL+U).
  766.  
  767.             To extract multiple files, use the SPACEBAR or CTRL+[LEFT MOUSE
  768.             BUTTON] keys to tag them.  To select all the files in the archive
  769.             directory, press CTRL+SPACEBAR.  Once the files have been tagged,
  770.             use CTRL+U or CTRL+ENTER to extract them.
  771.  
  772.             No masking is performed when archiving or extracting files.  In
  773.             other words, if a file's attribute is hidden or read-only, that
  774.             is how it will be archived or extracted by FileBUDDY.  If you
  775.             want to delete a file inside an archive, press DELETE on the
  776.             file.  To delete more than one file, tag the files first.  If an
  777.             archive file is password-protected, use CTRL+Z to enter the
  778.             password before viewing, deleting, or extracting files.
  779.  
  780.  
  781.             Viewing, Editing, Creating, And Printing dBASE Files
  782.             ====================================================
  783.  
  784.             Viewing dBASE files (including those archived) are no different
  785.             than viewing text files.  However, make note of the following
  786.             four keys as they take on a different meaning:
  787.  
  788.                   HOME            Go to the first record.
  789.                   END             Go to the last record.
  790.                   PGUP            Go to the previous record.
  791.                   PGDN            Go to the next record.
  792.  
  793.             When modifying a dBASE record, FileBUDDY sends the record to your
  794.             text editor for editing.  This method may seem a little
  795.             unorthodox at first but I think you will find it uncomplicated
  796.             and easy to work with.
  797.  
  798.             The first thing you'll probably notice after pressing CTRL+E is
  799.             the first line which contains the double angle brackets "<< >>".
  800.             This line determines how the record will be handled by FileBUDDY.
  801.             When the double angle brackets enclose a blank space, FileBUDDY
  802.             modifies the record (assuming changes were made).  If you want
  803.             to delete a record, substitute the blank space with a "-" like
  804.             "<<->>".  To undelete a record, simply substitute the "-" with a
  805.             blank space.  If you change your mind after modifying a record,
  806.             remove the space between the double angle brackets like "<<>>"
  807.             (or delete the line entirely) and FileBUDDY will ignore any
  808.             changes made to the record.  If you want to add a new record,
  809.             select any record in the database (with CTRL+E) and enter a "+"
  810.             between the angle brackets like "<<+>>".  Modify the record
  811.             fields as desired.  After you exit the text editor, FileBUDDY
  812.             will add the record to the dBASE file.
  813.  
  814.  
  815.  
  816.                                                                             12
  817.             A good idea before you modifying a record is to set your text
  818.             editor's cursor mode to INSERT so that when you edit a field, the
  819.             field boundaries (ie. "[" and "]") don't move.  Keep in mind that
  820.             this is not manditory as FileBUDDY itself doesn't care if they
  821.             move.  The field boundaries are there for your own visual
  822.             reference.
  823.  
  824.             If you need to modify (or add) many records in an archived dBASE
  825.             file, FileBUDDY will "constantly" ask you whether you want to
  826.             update the archive file.  To save time, answer "no" until the
  827.             last change you make to the file.
  828.  
  829.             When a dBASE record is deleted, the record is only marked for
  830.             deletion.  To physically remove a deleted record, you need to
  831.             "pack" the dBASE file.  You can do this in FileBUDDY with CTRL+K.
  832.             By default, FileBUDDY creates a backup copy before packing the
  833.             original dBASE file.  If you have limited disk space, you can
  834.             tell FileBUDDY not to create the backup with the 'DBFPackBackup'
  835.             parameter (see "Customizing FileBUDDY" under the [DBF] heading
  836.             for more information).
  837.  
  838.             When creating a dBASE file, FileBUDDY again relies on your text
  839.             editor.  A dBASE structure is created by pressing CTRL+B from
  840.             View mode (or from the DOS file directory).  A structure is
  841.             layed-out pretty much the same way a dBASE record is displayed in
  842.             FileBUDDY.  Take the following structure:
  843.  
  844.                     MEMBER: [C                           ]
  845.                      TITLE: [C                           ]
  846.                    ADDRESS: [C                                ]
  847.                       CITY: [C                ]
  848.                    ST_PROV: [C                ]
  849.                    COUNTRY: [C                ]
  850.                      PHONE: [C           ]
  851.                     JOINED: [D]
  852.                        DUE: [D]
  853.                        FEE: [N.2     ]
  854.                   MAILLIST: [L]
  855.                      NOTES: [M]
  856.  
  857.             Note how everything is aligned and capitalized.  This is not
  858.             necessary.  As long as the five components below are present,
  859.             FileBUDDY will decode each line properly:
  860.  
  861.                   Field Name              The field name should be no longer
  862.                                           than 10 characters.  Any field name
  863.                                           longer than 10 characters will be
  864.                                           truncated.  If there are leading
  865.                                           or trailing spaces in the field
  866.                                           name, they will be stripped.
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.                                                                             13
  874.                   Colon                   You MUST use a colon to separate
  875.                                           the field name from the left square
  876.                                           bracket.  If not found, the line
  877.                                           will not be processed.
  878.  
  879.                   Left Square Bracket     The left square bracket defines
  880.                                           the beginning of the field.  The
  881.                                           number of spaces between the left
  882.                                           bracket and the right bracket
  883.                                           sets the field length.
  884.  
  885.                   Field Type Character    This tells FileBUDDY what kind of
  886.                                           field it is.  Five data field types
  887.                                           are recognized:
  888.  
  889.                                           C    Defines a character field.
  890.                                                Any field that is not
  891.                                                explicitly defined will be
  892.                                                will be defined as a character
  893.                                                field.  Maximum field length
  894.                                                is 255.
  895.  
  896.                                           D    Defines a date field.  Field
  897.                                                length is automatically set
  898.                                                to 8.
  899.  
  900.                                           F    Defines a "Floating-Point"
  901.                                                field (in dBASE IV only).
  902.                                                To assign decimal places to
  903.                                                this field, append a period to
  904.                                                "F" and follow it with the
  905.                                                number of decimal places.  
  906.                                                Maximum field length is 20.
  907.  
  908.                                           L    Defines a logical field. Field
  909.                                                length is automatically set
  910.                                                to 1.
  911.  
  912.                                           M    Defines a dBASE III memo
  913.                                                field.  To create a dBASE IV
  914.                                                memo field, append a "4" to
  915.                                                the "M" character like "M4".
  916.                                                Field length is automatically
  917.                                                set to 10.
  918.  
  919.                                           N    Defines a numerical field.  To
  920.                                                assign decimal places to this
  921.                                                field, append a period to "N"
  922.                                                and follow it with the number
  923.                                                of decimal places (see
  924.                                                example).  Maximum field
  925.                                                length is 19 in dBASE III and
  926.                                                20 in dBASE IV.
  927.  
  928.  
  929.  
  930.                                                                             14
  931.                   Right Square Bracket    The right square bracket defines
  932.                                           the end of the field.  The number 
  933.                                           of spaces between the left bracket
  934.                                           and the right bracket determines
  935.                                           the field length.
  936.  
  937.             After you have created the dBase structure, records can be added.
  938.             When adding your first record, FileBUDDY displays a message to
  939.             the effect that no records exist.  Just press ESC to cancel the
  940.             message and then press CTRL+E.  When entering a date in a date
  941.             field, the date must be organized in the standard YYYYMMDD format
  942.             so that it can be used by FileBUDDY's expression evaluator (or
  943.             others for that matter).  Incidently, you can display information
  944.             on an existing DBF structure with CTRL+F1.
  945.  
  946.             To print a dBASE file (ie. CTRL+P), you have two options.  If you
  947.             have a few records to print, you can use Capture mode to capture
  948.             individual records to a file.  Once the records have been
  949.             captured, they can be printed.  The second option is to let
  950.             FileBUDDY select records based on an "expression" you provide.
  951.             The expression is placed in a "dBASE print form" file.  The
  952.             actual name of this file is the same name as the dBASE file but
  953.             with a .FRM extension.  For example, if the name of the file is
  954.             ADDBOOK.DBF you would give the dBASE print form file the name
  955.             ADDBOOK.FRM.  (Make sure it's located in the same directory as
  956.             the dBASE file.)
  957.  
  958.             The dBASE print form file also contains the formatting for each
  959.             record.  The SAMPLE.FRM file which comes with FileBUDDY shows
  960.             what a dBASE print form may look like:
  961.  
  962.                   EvalExp: "@COUNTRY" = "CANADA"
  963.                   ===========================================================
  964.                    Member: @MEMBER                     Title: @TITLE
  965.                   Address: @ADDRESS
  966.                      City: @CITY                  State/Prov: @ST_PROV
  967.                   Country: @COUNTRY                    Phone: @PHONE
  968.  
  969.             The first line of a dBASE print form contains the expression to
  970.             be evaluated.  If it isn't found, FileBUDDY assumes that you want
  971.             to print all records in the file.  Always precede your expression
  972.             with "EvalExp:" and make sure the colon "butts" up against the
  973.             "p".  Case is not important, however.  FileBUDDY's expression
  974.             evaluator supports both mathematical and logical operators and
  975.             evaluates expressions from LEFT TO RIGHT unless parenthesis are
  976.             used (which take precedence).  Valid operators are:
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                                                             15
  988.                   >   Greater than                &&  AND
  989.                   <   Less than                   ||  OR 
  990.                   >=  Greater than or equal to    *   Multiply
  991.                   <=  Less than or equal to       /   "Floating-Point" divide
  992.                   =   Equal to                    \   Integer divide
  993.                   !=  Not equal to                +   Add
  994.                   ~   Fuzzy search                -   Subtract
  995.                   !~  Not equal to fuzzy search
  996.  
  997.             Here are a few other sample "expressions":
  998.  
  999.                   EvalExp: "@JOINED" > "19920606" && ("@FEE" > "30")
  1000.                   EvalExp: "@MEMBER" ~ "DR."
  1001.                   EvalExp: "@FEE" > "100" && ("@FEE" < "200")
  1002.                   EvalExp: "@FEE" > ("@FEE" + "75.50")
  1003.                   EvalExp: "@ST_PROV" = "TX" && ("@COUNTRY" = "USA")
  1004.  
  1005.             The rest of the lines in the dBASE print form formats how each
  1006.             record will be printed.  As you may have surmised, the "@"
  1007.             character precedes a field name so that its contents are printed.
  1008.             (Field names are displayed when viewing a dBASE file.)  When
  1009.             designing a form, make sure that you take into consideration the
  1010.             field's total length.  Thus, don't place normal text too close to
  1011.             the right-side of a field as it may be overwritten by the field's
  1012.             contents (ie. text or blank spaces).  Use CTRL+F1 to get the
  1013.             lengths of each field.
  1014.  
  1015.             The location where page breaks occur when printing a dBASE file
  1016.             will depend upon how you set up your printer.  If you find your
  1017.             records get broken up during page breaks, you can either adjust
  1018.             the number of lines to be printed in your printer configuration
  1019.             (see "Printing Files") or you can add a few blank lines in your
  1020.             dBASE print form.  With reference to the SAMPLE.FRM example, you
  1021.             would add the blank lines after line 2.  Please note that the
  1022.             second line in the example is not necessary.  You can replace it
  1023.             with a blank line (or lines or whatever) since it is merely
  1024.             serving to separate records printed.  Alternatively, you can
  1025.             delete the second line altogether and place the "record
  1026.             separator" on the last line of the dBASE print form file.
  1027.  
  1028.  
  1029.             Viewing, Processing, Saving, And Printing Images
  1030.             ================================================
  1031.  
  1032.             Because there are so many SVGA video cards with different
  1033.             chipsets on the market, it is impossible to support them all.  If
  1034.             your video card is not designed around the ATI, Paradise,
  1035.             Trident, Tseng, Video 7, or "VESA" chipset, look for VESA
  1036.             compatibility in the form of a driver on the disks that came with
  1037.             your video card.  The driver allows FileBUDDY to select the video
  1038.             card's extended modes when displaying images larger than
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.                                                                             16
  1045.             320x200x256.  If you are unsuccessful in locating the VESA
  1046.             driver, check with the video card manufacturer (or call their BBS
  1047.             if they operate one).  Chances are one is available.
  1048.  
  1049.             Regardless of whether or not a VESA driver is available,
  1050.             FileBUDDY can display any image file size in the standard VGA
  1051.             mode of 320x200x256 although you'll still need to have enough
  1052.             system memory to hold the complete image.  When loading an image,
  1053.             FileBUDDY checks for expanded memory (EMS) or extended memory
  1054.             (XMS), in that order.  If found, it will be used to hold the
  1055.             image.  If not, the image will be loaded into conventional memory
  1056.             (memory permitting).  If you want to run FileBUDDY within Windows
  1057.             3.1, use the enclosed PIF file.  It enables FileBUDDY to take
  1058.             advantage of Window's virtual memory capability allowing images
  1059.             larger than RAM to be viewed.
  1060.  
  1061.             FileBUDDY always displays images in their proper aspect ratio.
  1062.             If your video card has a 32k, 64k, or 16m color mode, it will be
  1063.             used to display 24-bit images.  Images that are too large to
  1064.             display on your video card's best video mode can be navigated
  1065.             with the following keys:
  1066.  
  1067.                   HOME               Displays the top-left image corner.
  1068.                   END                Displays the bottom-right image corner.
  1069.                   CTRL+HOME          Displays the left image border.
  1070.                   CTRL+END           Displays the right image border.
  1071.                   UP CURSOR          Pans the view window up.
  1072.                   DOWN CURSOR        Pans the view window down.
  1073.                   LEFT CURSOR        Pans the view window left.
  1074.                   RIGHT CURSOR       Pans the view window right.
  1075.                   PGUP               Pages the view window up.
  1076.                   PGDN               Pages the view window down.
  1077.                   CTRL+LEFT CURSOR   Pages the view window left.
  1078.                   CTRL+RIGHT CURSOR  Pages the view window right.
  1079.  
  1080.             Cursor key resolution is defined with the INSERT key.  Enter
  1081.             values from 1 to 1000.  Because values represent "pixel" units,
  1082.             the smaller the number the finer the resolution.  The default
  1083.             value is set at 100 but can be changed with the 'ImageCsrRes'
  1084.             parameter in FBUDDY.INI.
  1085.  
  1086.             As an alternative to navigating through an image, you can get a
  1087.             "bird's eye" view of an image using the TAB key.  By pressing
  1088.             TAB, the image is resized to fit the selected video mode.  If you
  1089.             are viewing a large image and are not at the top-left corner of
  1090.             the image, make sure you press HOME first or FileBUDDY will
  1091.             resize just the portion displayed on the screen.
  1092.  
  1093.             If you want to view images in a "slide-show" style format, go to
  1094.             the file directory (ie. CTRL+O) and tag the desired image files
  1095.             with the SPACEBAR key (or use CTRL+SPACEBAR to tag all image
  1096.             files in the directory).  When files are tagged, no distinction
  1097.             is made between image files and non-image files.  However, non-
  1098.             image files are filtered out when CTRL+W is pressed to start the
  1099.  
  1100.  
  1101.                                                                             17
  1102.             slide-show.  Note also that no fancy "footwork" is performed when
  1103.             displaying images.  Thus, if an image is too large to fit in the
  1104.             video card's best resolution mode, not all of the image will be
  1105.             displayed.  You can, however, get around this by resizing the
  1106.             image beforehand by creating a new image file.  When doing so,
  1107.             select a new image size with the same proportions as the original
  1108.             so that the image will look "right".  For example, if your
  1109.             highest video card resolution is 800x600, resize a 640x731 image
  1110.             to 509x600.  To quit the slide-show, press CTRL+W again.  To
  1111.             bypass the delay period between images, press ENTER immediately
  1112.             after the image has loaded.
  1113.  
  1114.             One of FileBUDDY's most powerful features is its ability to
  1115.             process images (including 24-bit images).  Image processing,
  1116.             however, is "very" memory dependent.  If your computer does not
  1117.             have a lot of memory, don't be too surprised when the
  1118.             "Insufficient Memory" message is displayed.  Below are the image
  1119.             processing functions available:
  1120.  
  1121.                   CTRL+B             Changes the image brightness.  Images
  1122.                                      can be brighten four ways:
  1123.  
  1124.                                      1=All: Brightens all the pixels in the
  1125.                                      image.  Values range from -255 to 255.
  1126.                                      The higher the value, the brighter the
  1127.                                      image.
  1128.  
  1129.                                      2=Midrange: Increases intermediate
  1130.                                      brightness levels.
  1131.  
  1132.                                      3=Histogram Brighten: Brings out details
  1133.                                      of an image subject washed-out by a
  1134.                                      rear light source.
  1135.  
  1136.                                      4=Histogram Equalize: Brings out details
  1137.                                      in a dark image.
  1138.  
  1139.                                      5=Gamma: Expands intermediate
  1140.                                      brighteness levels.  Values range from
  1141.                                      0.1 to 10.  (Values entered are in the
  1142.                                      form of 1/x.)
  1143.  
  1144.                                      6=Multiply: Multiplies brightness level
  1145.                                      by a factor. 
  1146.  
  1147.                                      7=Divide: Divides brightness level by a
  1148.                                      factor.
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.                                                                             18
  1159.                   CTRL+C             Changes the image contrast by expanding
  1160.                                      the brightness range.  Lower and Upper
  1161.                                      values range from 0 to 255, where 0 is
  1162.                                      black and 255 is white and anything in
  1163.                                      between are shades of gray.
  1164.  
  1165.                   CTRL+E             Exchanges a selected brightness level
  1166.                                      range to a new brightness level.  Lower,
  1167.                                      Upper, and New values range from 0-Black
  1168.                                      to 255-White.
  1169.  
  1170.                   CTRL+G             Grayscales the color image.
  1171.  
  1172.                   CTRL+I             Inverts the image.
  1173.  
  1174.                   CTRL+J             Removes noise from image.
  1175.  
  1176.                   CTRL+K             Creates a kodalith image.  This is the
  1177.                                      same thing as a high contrast image.
  1178.                                      There are two ways to select an exposure
  1179.                                      (threshold):
  1180.  
  1181.                                      0=Auto: Calculates the average
  1182.                                      brightness level of the image.
  1183.  
  1184.                                      1=Set: Allows you to enter your own
  1185.                                      exposure.  Values range from 0 to 255.
  1186.  
  1187.                   CTRL+M             Creates a mirror image.
  1188.  
  1189.                   CTRL+N             Creates a "photographic" negative.
  1190.  
  1191.                   CTRL+R             Blurs the image.  Blurring values range
  1192.                                      from 1 to 255, where 255=Max Blurring.
  1193.  
  1194.                   CTRL+S             Sharpens the image.  Images can be
  1195.                                      sharpened two ways: 1=Gentle, 2=Course.
  1196.  
  1197.                   CTRL+T             Traces image outlines.  There are two
  1198.                                      ways to select an exposure (threshold):
  1199.  
  1200.                                      0=Auto: Calculates the average
  1201.                                      brightness level of the image.
  1202.  
  1203.                                      1=Set: Allows you to enter your own
  1204.                                      exposure.  Values range from 0 to 255.
  1205.  
  1206.                                      To create a B&W drawing from a color
  1207.                                      traced image, press CTRL+G and then
  1208.                                      CTRL+N.
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.                                                                             19
  1216.                   CTRL+V             Transforms an image using a convolution
  1217.                                      matrix.  "Convoluting" applies a 3x3
  1218.                                      matrix to each pixel in the image.  Ten
  1219.                                      values ranging from -127 to 127 are
  1220.                                      entered as a "string" and separated by
  1221.                                      commas.  The first 9 values are
  1222.                                      numerators while the last is the
  1223.                                      denominator (or divisor).  A string
  1224.                                      entered as "n1,n2,n3,n4,n5,n6,n7,n8,
  1225.                                      n9,d" represents the matrix:
  1226.  
  1227.                                                     n1  n2  n3
  1228.                                                     --  --  --
  1229.                                                     d   d   d
  1230.  
  1231.                                                     n4  n5  n6
  1232.                                                     --  --  --
  1233.                                                     d   d   d 
  1234.  
  1235.                                                     n7  n8  n9
  1236.                                                     --  --  --
  1237.                                                     d   d   d
  1238.  
  1239.                                      A matrix like
  1240.  
  1241.                                                     1/36  1/9  1/36
  1242.  
  1243.                                                     1/9   4/9  1/9
  1244.  
  1245.                                                     1/36  1/9  1/36
  1246.  
  1247.                                      is entered as:
  1248.  
  1249.                                           1,4,1,4,16,4,1,4,1,36
  1250.  
  1251.                                      When entering a string, feel free to
  1252.                                      break it up into "groups" with
  1253.                                      blank spaces to visually separate each
  1254.                                      matrix row.  For example:
  1255.              
  1256.                                           1,4,1,  4,16,4,  1,4,1,  36
  1257.  
  1258.                                      You will note when convoluting that the
  1259.                                      result MAY at times be on the dark side.
  1260.                                      You can correct this by brightening it
  1261.                                      with "1=All" using a value of 50 or 60.
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.                                                                             20
  1273.                                      Here are some other convolution matrix
  1274.                                      filters:
  1275.  
  1276.                                      * detect vertical lines:
  1277.                                           -1,0,1,-1,0,1,-1,0,1,1
  1278.                                      * detect horizonal lines:
  1279.                                           -1,-1,-1,0,0,0,1,1,1,1
  1280.                                      * detect diagonal lines:
  1281.                                           0,1,1,-1,0,1,-1,-1,0,1
  1282.                                      * gently sharpen:
  1283.                                           0,0,0,-1,3,-1,0,0,0
  1284.                                      * sharpen:
  1285.                                           -1,-1,-1,-1,9,-1,-1,-1,-1,1
  1286.                                      * outline:
  1287.                                           -1,-1,-1,-1,8,-1,-1,-1,-1
  1288.                                      * blur:
  1289.                                           1,1,1,1,1,1,1,1,1,9
  1290.  
  1291.                     CTRL+X           Pixellizes the image.  Values are from
  1292.                                      2 to 63.
  1293.  
  1294.                     CTRL+Z           Posterizes the image.  Values range from
  1295.                                      1 to 255.
  1296.  
  1297.             Most of FileBUDDY's image processing functions are irreversible
  1298.             unless you set the ImageRestore  parameter to "yes".  Therefore
  1299.             if you sharpen an image, you can undo the sharpen by pressing
  1300.             CTRL+BACKSPACE.  Keep in mind that if you don't have enough
  1301.             memory you will not be able to restore the process.
  1302.  
  1303.             To aid in image processing, FileBUDDY lets you create a histogram
  1304.             of an image using CTRL+H.  An image histogram is simply a graph
  1305.             showing the distribution of brightness levels relative to the
  1306.             number of pixels in the image.  Dark images (or images with dark
  1307.             backgrounds) will have most of their pixels graphed at the low
  1308.             end of the brightness scale.  Bright images (or images with
  1309.             bright backgrounds) will have most of their pixels graphed at the
  1310.             high end of the brightness scale.
  1311.  
  1312.             Another of FileBUDDY's powerful features is its ability to crop
  1313.             images.  Images are cropped by holding down one of the SHIFT keys
  1314.             and then pressing an appropriate cursor key.  The cursor keys
  1315.             represent the 4 borders of the image: the UP cursor represents
  1316.             the top border, the DOWN cursor the bottom border, the LEFT
  1317.             cursor the left border, and the RIGHT cursor the right border.
  1318.             The direction in which the image borders will move is determined
  1319.             by the SHIFT keys.  The left SHIFT key moves the borders OUTWARD
  1320.             while the right SHIFT key moves the borders INWARD.  To help you
  1321.             remember, think of the left SHIFT as the furthest OUT from the
  1322.             cursor keys and the right SHIFT as the closest IN to the cursor
  1323.             keys.  If you have any problems remembering, press F1 for help.
  1324.             If you need to adjust the "cropping resolution", use INSERT to
  1325.             change it.  To undo any cropping, press BACKSPACE.
  1326.  
  1327.  
  1328.  
  1329.                                                                             21
  1330.             If you are cropping a very large image, say, by bringing the
  1331.             right border in and you are viewing the top-left corner of the
  1332.             image, it may seem like nothing is happening (except for the
  1333.             image being redrawn).  Don't be fooled.  Remember that your
  1334.             screen is acting like a window to the image.  To see the border
  1335.             being adjusted, position yourself at the right border with
  1336.             CTRL+END.
  1337.  
  1338.             You can rotate an image using the CTRL+PGDN or CTRL+PGUP keys.
  1339.             The CTRL+PGDN keys rotates the image clockwise whereas the
  1340.             CTRL+PGUP keys rotates it counterclockwise.
  1341.  
  1342.             A by-product of the cropping feature is the ability to zoom in on
  1343.             an area of an image.  For example, if you have an image of a
  1344.             person's face and wanted to zoom in on the left eye, crop the
  1345.             image until only the left eye is showing.  Then press the TAB key
  1346.             to resize the eye to fill the screen.  To "unzoom", just press
  1347.             the BACKSPACE key.
  1348.  
  1349.             Images which have been processed or cropped, or those that need
  1350.             to be converted to different formats can be saved with the
  1351.             following function keys:
  1352.  
  1353.                Key Format Compression                Depth       Notes
  1354.  
  1355.                F2  BIF    None                        8          Binary
  1356.                F3  GIF    LZW                         4,8        87a/89a
  1357.                F4  PCX    RLE                         1,8
  1358.                F5  EPS                                8          EPSF2.0/3.0
  1359.                F6  TGA    None,RLE                    16,24,32   Saves 24-bit
  1360.                F7  TIF    None,LZW,PackBits,G3,G4     1,8,24
  1361.                F8  BMP    None,RLE                    1,4,8,24
  1362.                F9  JPEG   Quality 1-100               8,24
  1363.  
  1364.             When saving an image, you'll be asked to enter the image's new
  1365.             dimensions (like 320x200, 640x480, 1024x768, or whatever).  Press
  1366.             ENTER to accept the image's original dimensions.  The path where
  1367.             the image will be saved is defined by the 'WorkDir' parameter in
  1368.             FBUDDY.INI.  The default image name will be the same as the
  1369.             original image name but with appropriate extension.
  1370.  
  1371.             When loading a BIF (binary) image, unlike the other image
  1372.             formats, you'll be asked to enter its dimensions.  This is
  1373.             because the format does not save any information about the image.
  1374.             The default image size is set at 320x200.  You may have to
  1375.             experiment with different sizes until you find the right size to
  1376.             capture the complete image.
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.                                                                             22
  1387.             If a HP LaserJet, HP DeskJet 500c (color), or Epson 24-pin  (or
  1388.             compatible) printer is available, images can be printed by
  1389.             selecting CTRL+P.  You will be prompted with the following:
  1390.  
  1391.                   1.  Image Destination (printer or file)
  1392.                   2.  Image Dimensions
  1393.                   3.  Brightness Level (Gamma Correction)
  1394.                   4.  Printer Resolution (DPI)
  1395.  
  1396.             Gamma correction values range from .1 to 10, where 2 is the
  1397.             default.  Even so, you may need to experiment with different
  1398.             settings as it is dependent on the image.
  1399.  
  1400.             Printer resolution allows you to define the quality of the image
  1401.             printed.  The lower the resolution, the lower the quality.  If
  1402.             you want to print an image quickly, you would of course choose a
  1403.             low resolution like 75 DPI.  The default setting is what you
  1404.             specified in your FBUDDY.INI file.  When printing at high
  1405.             resolutions like 300 DPI, be patient.  This is especially true
  1406.             with large images or when enlarging images.  You may cancel a
  1407.             print job with ESC at anytime.  Please note that there's a delay
  1408.             when cancelling as FileBUDDY responds at 10% intervals.
  1409.  
  1410.             Sometimes the printed image's aspect ratio may not look the same
  1411.             as the image on the screen.  This is NOT an error with FileBUDDY.
  1412.             What's happening is that when an image is displayed on a video
  1413.             monitor, the monitor's aspect ratio changes the image's apparent
  1414.             aspect ratio.  This is especially noticeable when printing an
  1415.             image of a person's face.  To compensate for this "distortion",
  1416.             increase the length of the image slightly.  For example, if the
  1417.             image's dimensions are 320x200, change it to 320x225.
  1418.  
  1419.             To print an image in landscape mode, rotate the image with the
  1420.             CTRL+PGDN or CTRL+PGUP keys.  If you want to change the border
  1421.             thickness drawn around the image, redefine 'ImageBorder' in
  1422.             FBUDDY.INI.  (For more information on this parameter, refer to
  1423.             "Customizing FileBUDDY" under the [IMAGE] parameter heading.)
  1424.  
  1425.             If you don't have one of the supported printers (see the
  1426.             'ImagePrinter' parameter in the "Customizing FileBUDDY" section),
  1427.             you can print the image to file by pressing "F" or "f" after
  1428.             selecting CTRL+P.  The file can then be printed from the command
  1429.             line on another computer connected to the proper printer using:
  1430.  
  1431.                   copy imagename lpt1 /b
  1432.  
  1433.             If the laser printer is connected to "lpt2" or "lpt3", substitute
  1434.             accordingly.  Make sure you use the "/b" switch to ensure the
  1435.             whole file is printed.
  1436.  
  1437.             Information about an image can be obtained using CTRL+F1.  For a
  1438.             list of image commands, press F1.  To load another image file,
  1439.             press ESC or CTRL+O to display the DOS file directory.
  1440.  
  1441.  
  1442.  
  1443.                                                                             23
  1444.             Customizing FileBUDDY
  1445.             =====================
  1446.  
  1447.             FileBUDDY stores "modifiable" parameters in FBUDDY.INI.  Since
  1448.             the file is in ASCII format, you can easily customize them with
  1449.             any text editor.  Below is a description of each parameter:
  1450.  
  1451.                   [INITIALIZATION]   The parameters under this heading are
  1452.                                      required for FileBUDDY to run properly.
  1453.                                      Make sure that you do not delete them
  1454.                                      unless noted.
  1455.  
  1456.                   Version            FileBUDDY version.
  1457.  
  1458.                   MouseSen           Sets the mouse sensitivity.  Useful 
  1459.                                      values are between 0 and 100, where 0 is
  1460.                                      the most sensitive.
  1461.  
  1462.                   MouseSS            Sets the mouse scroll speed.  Use values
  1463.                                      starting from 0.  The higher the time
  1464.                                      delay value, the slower the scrolling.
  1465.  
  1466.                   MouseLBSS          Sets the mouse scroll speed for list
  1467.                                      boxes (ie. DOS and archive file
  1468.                                      directory).  The higher the time delay
  1469.                                      value, the slower the scrolling.
  1470.  
  1471.                   TabSpaces          Sets the amount of spaces each TAB
  1472.                                      character represents.  If this parameter
  1473.                                      is not found, the default is set
  1474.                                      internally to 8.
  1475.  
  1476.                   ExitOnEsc          Determines whether pressing ESC from the
  1477.                                      DOS file directory will exit FileBUDDY
  1478.                                      if no file is selected.  FALSE/NO/0=
  1479.                                      Don't Exit On ESC, TRUE/YES/1=Exit On
  1480.                                      ESC
  1481.  
  1482.                   FileSort           Determines how file directory names will
  1483.                                      be sorted.  0=Don't Sort, 1=Sort By 
  1484.                                      Name, 2=Sort By Extension
  1485.  
  1486.                   PrnConfigSort      Determines whether the printer 
  1487.                                      configuration names will be sorted.
  1488.                                      0=Don't Sort, 1=Sort
  1489.  
  1490.                   BeepSound          Sets the type of "beep sound" for error
  1491.                                      messages.  Values range from 0 to 10.
  1492.                                      FALSE/NO/0=No Sound
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.                                                                             24
  1500.                   Shadow             Determines whether a shadow will be
  1501.                                      projected when a list box is displayed.
  1502.                                      FALSE/NO/0=No Shadow, TRUE/YES/1=Shadow
  1503.  
  1504.                   Border             Sets the main borders in the program.
  1505.                                      Five options are available:
  1506.  
  1507.                                      1 = Single line all around
  1508.                                      2 = Double line all around
  1509.                                      3 = Double line horizontally, single
  1510.                                          line vertically
  1511.                                      4 = Single line horizontally, double
  1512.                                          line vertically
  1513.  
  1514.                                      FALSE/NO/0 = No border
  1515.  
  1516.                   LBBorder           Sets the list box border type.  (See
  1517.                                      'Border' parameter for list.)
  1518.  
  1519.                   HelpBorder         Sets the Help box border type.  (See
  1520.                                      'Border' parameter for list.)
  1521.  
  1522.                   TextColor          Sets the main text color.
  1523.  
  1524.                   LBTextColor        Sets the list box text color.
  1525.  
  1526.                   BorderColor        Sets the main border color.
  1527.  
  1528.                   LBBorderColor      Sets the list box border color.
  1529.  
  1530.                   HelpTextColor      Sets the Help text color.
  1531.  
  1532.                   HelpBorderColor    Sets the Help list box border color.
  1533.  
  1534.                   HMBarColor         Sets the text color for the menus and
  1535.                                      messages.
  1536.  
  1537.                   HiLiteColor        Sets the highlight text color.
  1538.  
  1539.                   FileNameColor      Sets the filename text color.
  1540.  
  1541.                   LBCsrColor         Sets the list box cursor color.
  1542.  
  1543.                   MouseCsrColor      Sets the mouse cursor color.  (This
  1544.                                      parameter will be set to -1 if FileBUDDY
  1545.                                      is configured for "black & white".)
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.                                                                             25
  1557.                   [SWAP]             Parameters under this heading tell
  1558.                                      FileBUDDY when and where to swap from
  1559.                                      conventional memory.  When swapping to
  1560.                                      XMS or EMS, FileBUDDY will store the
  1561.                                      "swap kernel" in an UMB (if available)
  1562.                                      instead of conventional memory.  If
  1563.                                      there is not enough memory when swapping
  1564.                                      to XMS or EMS, swapping will default to
  1565.                                      disk.
  1566.  
  1567.                   SwapWhenEditor     Determines whether FileBUDDY will swap
  1568.                                      out of conventional memory when shelling
  1569.                                      to your editor.  FALSE/NO/0=Don't Swap
  1570.                                      (default), 1=Disk, 2=EMS, 3=XMS
  1571.  
  1572.                   SwapWhenArchiver   Determines whether FileBUDDY will swap 
  1573.                                      out of conventional memory when shelling
  1574.                                      to your archiver.  FALSE/NO/0=Don't Swap
  1575.                                      (default), 1=Disk, 2=EMS, 3=XMS
  1576.  
  1577.                   SwapWhenImage      Determines whether FileBUDDY will swap 
  1578.                                      part of itself from conventional memory
  1579.                                      when loading an image.
  1580.                                      FALSE/NO/0=Don't Swap, 1=Disk (Default),
  1581.                                      2=EMS, 3=XMS.
  1582.  
  1583.                   SwapWhenDOS        Determines whether FileBUDDY will swap 
  1584.                                      out of conventional memory when shelling
  1585.                                      to DOS. FALSE/NO/0=Don't Swap (default),
  1586.                                      1=Disk, 2=EMS, 3=XMS.
  1587.  
  1588.                   SwapWhenAssociate  Determines whether FileBUDDY will swap
  1589.                                      out of conventional memory when shelling
  1590.                                      to an "associated" program.  
  1591.                                      FALSE/NO/0=Don't Swap (default), 1=Disk,
  1592.                                      2=EMS, 3=XMS.
  1593.  
  1594.                   SwapEMS320         If you are having problems swapping to 
  1595.                                      expanded memory (EMS), you may want to
  1596.                                      set this parameter to TRUE, YES, or 1.
  1597.                                      This forces FileBUDDY to use EMS 3.2
  1598.                                      level functions (instead of EMS 4.0
  1599.                                      functions).
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.                                                                             26
  1614.                   [DEFINE]           Parameters under this heading define
  1615.                                      how certain files are to be treated.
  1616.  
  1617.                   OtherArcExt        Lets you define an archiver to a file
  1618.                                      extension.  For example, if you wanted
  1619.                                      to view a QWK file compressed with LHA,
  1620.                                      you would set it up as:
  1621.  
  1622.                                           OtherArcExt=LZH:QWK
  1623.  
  1624.                                      (Should you decide to view a QWK file,
  1625.                                      you must also include DAT:227 in the
  1626.                                      'FileEOLChar' parameter.)
  1627.  
  1628.                                      To specify more than one extension, you
  1629.                                      would expand it using commas:
  1630.  
  1631.                                           OtherArcExt=LZH:QWK,ARJ:SDN,ZIP:BAK
  1632.  
  1633.                                      Note how you can associate different 
  1634.                                      files to different archivers.
  1635.  
  1636.                   FileEOLChar        Allows you to define an "End-Of-Line"
  1637.                                      character to a file extension for
  1638.                                      FileBUDDY to use when parsing lines.
  1639.                                      For example:
  1640.  
  1641.                                           FileEOLChar=PLX:10,DAT:227
  1642.  
  1643.                                      The comma is used to expand the
  1644.                                      parameter so that more than one file
  1645.                                      type can be processed.
  1646.  
  1647.                   Associate#         Links a file extension to a program
  1648.                                      for FileBUDDY to use when CTRL+A
  1649.                                      is pressed (from the file/archive
  1650.                                      directory).  The # character is a value
  1651.                                      from 1 to 5.  For example:
  1652.  
  1653.                                           Associate1=WKS:c:\utils\spread.exe
  1654.  
  1655.                                      Make sure to define 'SwapWhenAssociate'
  1656.                                      if your program won't load due to 
  1657.                                      insufficient memory.
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.                                                                             27
  1671.                   [PATHS]            Parameters under this heading specify
  1672.                                      the paths and programs used by
  1673.                                      FileBUDDY.  When specifying program
  1674.                                      names, you MUST add the PATH and
  1675.                                      EXTENSION or they won't be located, even
  1676.                                      if they are in your PATH statement.
  1677.  
  1678.                                      When specifying archiving programs, the
  1679.                                      following are recognized by FileBUDDY:
  1680.              
  1681.                                           ARC v6.00
  1682.                                           ARCE v3.1, v4.0g
  1683.                                           ARJ v2.10-v2.30
  1684.                                           LHA v1.14, v2.10-v2.13
  1685.                                           PAK v2.51
  1686.                                           PKZIP v1.10, v2.04
  1687.  
  1688.                                      Previous or future versions of the
  1689.                                      archivers may or may not work.  All you
  1690.                                      can do is try and see.
  1691.  
  1692.                   TempDir            Sets FileBUDDY's temporary work
  1693.                                      directory path.  By default, this
  1694.                                      parameter does not appear in FBUDDY.INI
  1695.                                      thus creating the temporary work
  1696.                                      directory in FileBUDDY's directory.
  1697.                                      To use it, add it manually and set it up
  1698.                                      like:
  1699.  
  1700.                                           TempDir=c:
  1701.                                      or
  1702.                                           TempDir=c:\utils
  1703.  
  1704.                                      When viewing archived files, FileBUDDY
  1705.                                      decompresses them to the temporary work
  1706.                                      directory.  If FileBUDDY is installed on
  1707.                                      a floppy disk and you tried to view a
  1708.                                      large archived file, you would in all
  1709.                                      likelihood run out of disk space.  This
  1710.                                      parameter allows you to specify an
  1711.                                      alternate path so that the file would
  1712.                                      not decompress on the floppy disk.
  1713.  
  1714.                   WorkDir            Defines YOUR work directory path.  For
  1715.                                      example:
  1716.  
  1717.                                           WorkDir=c:\temp
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.                                                                             28
  1728.                   Editor             This parameter allows you to specify
  1729.                                      the text editor or word-processor of
  1730.                                      your choice.  Assuming your editor is
  1731.                                      called "edit.com" and located in c:\dos,
  1732.                                      you would set it up as:
  1733.  
  1734.                                           Editor=c:\dos\edit.com
  1735.  
  1736.                   ARC                This parameter recognizes three
  1737.                                      different archivers.  They are ARC.EXE
  1738.                                      by SEA, ARCE.COM by Wayne Chin/Vernon D.
  1739.                                      Buerg and PAK.EXE by NoGate Consulting.
  1740.                                      Below are examples to set each up:
  1741.  
  1742.                                      - Assuming you want to use ARC for
  1743.                                      "ARCs" and the archiver is located in
  1744.                                      c:\utils\arc, set it up as:
  1745.  
  1746.                                           ARC=c:\utils\arc\arc.exe
  1747.  
  1748.                                      - Assuming you want to use ARCE for
  1749.                                      "ARCs" and the archiver is located in
  1750.                                      c:\utils\arc, set it up as:
  1751.  
  1752.                                           ARC=c:\utils\arc\arce.com
  1753.  
  1754.                                      - Assuming you want to use PAK for
  1755.                                      "ARCs" and the archiver is located in
  1756.                                      c:\utils\pak, set it up as:
  1757.  
  1758.                                           ARC=c:\utils\pak\pak.exe
  1759.  
  1760.                   ARJ                This parameter recognizes one archiver.
  1761.                                      The archiver is called ARJ.EXE by Robert
  1762.                                      K. Jung.  Assuming the archiver is
  1763.                                      located in c:\utils\arj, set it up as:
  1764.  
  1765.                                           ARJ=c:\utils\arj\arj.exe
  1766.  
  1767.                   LZH                This parameter recognizes one archiver.
  1768.                                      The archiver is called LHA.EXE by
  1769.                                      Haruyasu Yoshizaki.  Assuming the 
  1770.                                      archiver is located in c:\utils\lha, set
  1771.                                      it up as:
  1772.  
  1773.                                           LZH=c:\utils\lha\lha.exe
  1774.  
  1775.                   PAK                This parameter recognizes one archiver.
  1776.                                      The archiver is called PAK.EXE by NoGate
  1777.                                      Consulting.  Assuming the archiver is
  1778.                                      located in c:\utils\pak, set it up as:
  1779.  
  1780.                                           PAK=c:\utils\pak\pak.exe
  1781.  
  1782.  
  1783.  
  1784.                                                                             29
  1785.                   ZIP                This parameter recognizes two archivers.
  1786.                                      They are PKZIP.EXE by PKWare and PAK.EXE
  1787.                                      by NoGate Consulting.  Below are 
  1788.                                      examples to set each up:
  1789.  
  1790.                                      - Assuming you want to use PKZIP for
  1791.                                      "ZIPs" and the archiver is located
  1792.                                      in c:\utils\pkzip, set it up as:
  1793.  
  1794.                                           ZIP=c:\utils\pkzip\pkzip.exe
  1795.  
  1796.                                      - Assuming you want to use PAK for
  1797.                                      "ZIPs" and the archiver is located in
  1798.                                      c:\utils\pak, set it up as:
  1799.  
  1800.                                           ZIP=c:\utils\pak\pak.exe
  1801.  
  1802.                   [ARCHIVE]          This heading marks the location of the
  1803.                                      archiving parameters.
  1804.  
  1805.                   Compression        Specifies the method of compression:
  1806.                                      1=Size, 2=Size/Speed, 3=Speed.  This
  1807.                                      parameter applies to archivers that
  1808.                                      support it.
  1809.  
  1810.                   SFXModel           Specifies the model that FileBUDDY will
  1811.                                      use when creating a self-extracting
  1812.                                      file: 1=Small Model, 2=Large Model.
  1813.                                      This parameter applies to archivers
  1814.                                      that support it.
  1815.  
  1816.                   ResetArchivePW     Determines whether the password will be
  1817.                                      cleared after archiving or extracting/
  1818.                                      deleting archived files.
  1819.                                      FALSE/NO/0=Don't Reset Password,
  1820.                                      TRUE/YES/1=Reset Password.  If set
  1821.                                      to "YES", remember that should you
  1822.                                      decide to archive files after viewing a
  1823.                                      password-protected archive, the password
  1824.                                      will be used.  Make sure to clear the
  1825.                                      password manually.
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.                                                                             30
  1842.                   [DBF]              This heading marks the location of the 
  1843.                                      dBASE parameters.
  1844.  
  1845.                   DBFPackBackup      Determines whether a backup will be 
  1846.                                      created before packing a dBASE file:
  1847.                                      FALSE/NO/0=Don't Create Backup,
  1848.                                      1=Create Backup, 2=Create Backup Disk
  1849.                                      Space Permitting.  When set to "1" and
  1850.                                      not enough disk space is available,
  1851.                                      packing will not proceed.  The backup
  1852.                                      name created will be the same as the DBF
  1853.                                      name but with the ".BAK" extension.
  1854.                                      (The backup file is deleted if the
  1855.                                      backup is successful.)
  1856.  
  1857.                   [IMAGE]            This heading marks the location of the
  1858.                                      image parameters.
  1859.  
  1860.                   SlideShowPause     Sets the delay period (in seconds)
  1861.                                      between images when "slide-show"
  1862.                                      viewing.  Time values range from
  1863.                                      0 to 2400.
  1864.  
  1865.                   DisableHiColor     Disables video cards with 32k, 64k, or
  1866.                                      16m modes so that 24-bit (RGB) images
  1867.                                      are displayed as 8-bit (256 colors).
  1868.                                      YES/TRUE/1=Disable, NO/FALSE/0=Don't 
  1869.                                      Disable
  1870.  
  1871.                   Image1BitFormat    Defines how other images will be
  1872.                                      converted to 1-bit images.  0=Scatter
  1873.                                      (error diffusion), 1=Ordered Dither,
  1874.                                      2=Threshold (B&W)
  1875.  
  1876.                   ImageRestore       Sets whether you will be able to restore
  1877.                                      an image after processing it.  
  1878.                                      NO/FALSE/0=Don't Backup Image Before
  1879.                                      Processing, YES/TRUE/1=Backup Image
  1880.                                      Before Processing
  1881.  
  1882.                   ImageCsrRes        Sets the resolution of the cursor keys.
  1883.                                      Pixel values range from 1 to 1000.
  1884.                                      Thus, the smaller the value the finer
  1885.                                      the resolution.
  1886.  
  1887.                   ImagePrinter       Defines the image printer.
  1888.                                      0=HP LaserJet, 1=Epson 24-pin dot-
  1889.                                      matrix, 2=HP DeskJet 500c.  (Values
  1890.                                      also apply to their "compatibles".)
  1891.  
  1892.                   ImageLPT           Specifies the image's printer port.
  1893.                                      1=LPT1, 2=LPT2, 3=LPT3
  1894.  
  1895.  
  1896.  
  1897.  
  1898.                                                                             31
  1899.                   ImageDPI           Sets the resolution of the image printer
  1900.                                      and is expressed in "dots per inch" (ie.
  1901.                                      DPI).  Valid printer resolutions for HP
  1902.                                      LaserJet printers are: 75, 100, 150,
  1903.                                      200, 300, 600, 1200.  (The latter two
  1904.                                      resolutions only apply to printers that
  1905.                                      support it.)  For HP DeskJet 500c
  1906.                                      printers the resolutions are: 75, 100,
  1907.                                      150, 300.  For Epson 24-pin printers,
  1908.                                      only the 180 DPI mode is supported.
  1909.                                      (All values also apply to their
  1910.                                      "compatibles".)
  1911.  
  1912.                   ImagePrtMode       Valid print modes are: 0=Scatter,
  1913.                                      1=Halftone, 2=Color.  The scatter
  1914.                                      technique also referred to as "error
  1915.                                      diffusion" normally produces a sharper
  1916.                                      and more detailed picture but takes 20%
  1917.                                      longer to print.  Use this mode for
  1918.                                      offset printing.  If you plan to
  1919.                                      photocopy the image, use mode 1
  1920.                                      (halftone technique).
  1921.  
  1922.                   ImageSize          Sets the overall size of the image.
  1923.                                      This parameter actually defines the
  1924.                                      image's width.  (The image's length is
  1925.                                      automatically defined by the image's
  1926.                                      aspect ratio.)  Use values greater than
  1927.                                      0.  A value of 1000 is equivalent to 1"
  1928.                                      or 2.54 cm.  Printed images are
  1929.                                      automatically limited to 7999 x 10999
  1930.                                      (dots) in size.
  1931.  
  1932.                   ImageRow           Sets the "row" coordinate where the
  1933.                                      image will be printed on the paper.
  1934.                                      Values are with reference to the top
  1935.                                      upper-left corner of the paper oriented
  1936.                                      in the vertical position.  It is
  1937.                                      expressed in 1/1000 inch.  A value of
  1938.                                      1000 would therefore represent 1 inch or
  1939.                                      2.54 cm.  Use values starting from 0.
  1940.  
  1941.                   ImageColumn        Sets the "column" coordinate where the
  1942.                                      image will be printed on the paper.
  1943.                                      Values are with reference to the top
  1944.                                      upper-left corner of the paper oriented
  1945.                                      in the vertical position.  It is
  1946.                                      expressed in 1/1000 inch.  A value of
  1947.                                      1000 would therefore represent 1 inch or
  1948.                                      2.54 cm.  Use values starting from 0.
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.                                                                             32
  1956.                   ImageBorder        Determines the thickness of the border
  1957.                                      around the image in DPI units.  A "2"
  1958.                                      for example represents a "2-dot-border".
  1959.                                      Use values starting from 0.  The higher
  1960.                                      the number the thicker the border.
  1961.                                      FALSE/NO/0=No Border
  1962.  
  1963.                   [Printer]          This heading marks the location where
  1964.                                      printer configurations are stored.
  1965.                                      Refer to "Printing Files" for help on
  1966.                                      creating your own.
  1967.  
  1968.                   PrnSetupDefault    Stores a default printer configuration
  1969.                                      name.  This is normally defined within
  1970.                                      FileBUDDY from the Utilities Menu with
  1971.                                      SetConfigDefault.  Make sure this
  1972.                                      parameter precedes all your printer
  1973.                                      configurations.
  1974.  
  1975.                   The rest of the FBUDDY.INI file is used to store your
  1976.                   printer configurations.
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.                                                                             33
  2013.             Contacting The Author
  2014.             =====================
  2015.  
  2016.             If you are experiencing any problems with FileBUDDY or have a
  2017.             suggestion or criticism you'd like to make, please write to me.
  2018.             I would like to hear from you.  Write to me at:
  2019.  
  2020.                   Lenard Dean
  2021.                   Box 73094, Woodbine Postal Outlet
  2022.                   Calgary, Alberta  T2W6E0
  2023.                   CANADA
  2024.  
  2025.             You can also reach me on CompuServe at 70312,415
  2026.  
  2027.             Happy viewing!
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.                                                                             34
  2070.             Appendix A
  2071.             ==========
  2072.  
  2073.  
  2074.             Registration Information
  2075.             ------------------------
  2076.  
  2077.             FileBUDDY is being distributed as SHAREWARE.  This method of
  2078.             distribution means that you may evaluate FileBUDDY for a
  2079.             reasonable period of time, normally 30 days.  (In my case, I'll
  2080.             leave the "reasonable" part up to you.)  If you find that
  2081.             FileBUDDY meets your needs and you continue to use it, please
  2082.             register your copy.
  2083.  
  2084.             The registration fee for FileBUDDY is $20 US.  When you register,
  2085.             you will receive a printed manual and the latest version of
  2086.             FileBUDDY.  As an incentive to register, the registration fee
  2087.             applies to all future releases of FileBUDDY.  Since there is no
  2088.             difference between the Shareware and Registered version, you are
  2089.             free to upgrade as new versions are released.  (If you wish to
  2090.             order a new manual and disk for a major upgrade, I will be more
  2091.             than happy to supply them to you at a nominal cost.)
  2092.  
  2093.             Money orders or personal, certified, and traveller's checks are
  2094.             accepted.  If you are paying by personal check, payment does not
  2095.             necessarily have to be in US funds.  Local currency is acceptable
  2096.             as long as the amount is equivalent to the amount in US dollars.
  2097.             Check with your bank for the current exchange rate "for you to
  2098.             buy" US dollars.  If you are ordering outside North America,
  2099.             please don't forget to add the additional $3.00 US for shipping
  2100.             (even if you want it sent by registered mail).
  2101.  
  2102.             Thank you for your support.
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.                                                                             35
  2127.             APPENDIX B
  2128.             ==========
  2129.  
  2130.  
  2131.             Color Chart
  2132.             -----------
  2133.  
  2134.  
  2135.                                              BACKGROUND
  2136.  
  2137.                         Black  Blue  Green  Cyan  Red  Magenta  Brown  White
  2138.  
  2139.                Black       0    16     32    48    64     80      96    112
  2140.                Blue        1    17     33    49    65     81      97    113
  2141.                Green       2    18     34    50    66     82      98    114
  2142.             F  Cyan        3    19     35    51    67     83      99    115
  2143.             O  Red         4    20     36    52    68     84     100    116
  2144.             R  Magenta     5    21     37    53    69     85     101    117
  2145.             E  Brown       6    22     38    54    70     86     102    118
  2146.             G  White       7    23     39    55    71     87     103    119
  2147.             R  Grey        8    24     40    56    72     88     104    120
  2148.             O  BrBlue      9    25     41    57    73     89     105    121
  2149.             U  BrGreen    10    26     42    58    74     90     106    122
  2150.             N  BrCyan     11    27     43    59    75     91     107    123
  2151.             D  BrRed      12    28     44    60    76     92     108    124
  2152.                BrMagenta  13    29     45    61    77     93     109    125
  2153.                Yellow     14    30     46    62    78     94     110    126
  2154.                BrWhite    15    31     47    63    79     95     111    127
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.                                                                             36
  2184.             APPENDIX C
  2185.             ==========
  2186.  
  2187.  
  2188.             Questions And Answers
  2189.             ---------------------
  2190.  
  2191.             Q: Why is there a delay when reading an archive directory?
  2192.  
  2193.             A: Because FileBUDDY has to wait for the archiver to create the
  2194.                "xxxINFO" file.  If the archive is self-extracting and has a
  2195.                security envelope, there may be an even longer delay.
  2196.  
  2197.             Q: When trying to view a ZIPed file, I get a "Disk Full Or
  2198.                Bad Archive" error message.  I'm told that there is nothing
  2199.                wrong with the ZIP file.  What's wrong?
  2200.  
  2201.             A: This message can occur if you try to view a file archived with
  2202.                PKZIP v2.00's new compression algorithm using PKZIP v1.10.
  2203.                The solution is to use PKZIP v2.00 or better.
  2204.  
  2205.             Q: When I try to archive files that are on a floppy drive with
  2206.                PKZIP, I get a "Disk Full Or Bad Archive" error message.  I
  2207.                have the "TempDir" parameter in my FBUDDY.INI file set to
  2208.                "C:".  What's wrong?
  2209.  
  2210.             A: This is a PKZIP "quirk".  You can get around this problem with
  2211.                "SET PKTMP=C:" in your AUTOEXEC.BAT file.
  2212.  
  2213.             Q: When I try to view EXE files that have been "PKLITEd",
  2214.                FileBUDDY tries to unZIP them.  Why is that?
  2215.  
  2216.             A: Because FileBUDDY has no way of knowing if they are self-
  2217.                extracting.
  2218.  
  2219.             Q: When extracting lots of files within a LZH archive, my screen
  2220.                goes blank.  Why?
  2221.  
  2222.             A: This is a quirk with LHA as it is manipulating the display
  2223.                directly.  Once all the files have been extracted, FileBUDDY
  2224.                will redraw the screen.
  2225.  
  2226.             Q: When I try to run FBUDDYI.EXE nothing happens.  What am I
  2227.                doing wrong?
  2228.  
  2229.             A: FileBUDDY is invoked with FBUDDY.EXE.  Only FBUDDY.EXE has
  2230.                access to FBUDDYI.EXE.
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.                                                                             37
  2241.             Q: When I try to view certain GIF files I get an "Unreadable
  2242.                GIF format".  Why is that?
  2243.  
  2244.             A: Assuming the files are not corrupted, FileBUDDY cannot read
  2245.                GIF images of less than 4-bit pixel depth.
  2246.  
  2247.             Q: Can I view archived image files?
  2248.  
  2249.             A: Sure.  As a matter of fact depending on the image format (like
  2250.                uncompressed TIFs), you can reclaim a significant amount of
  2251.                disk space if you archive your uncompressed image files.
  2252.  
  2253.             Q: I'm having problems displaying an image on a "supported" video
  2254.                card.  As far as I know the image is fine.  Any suggestions?
  2255.  
  2256.             A: Install the VESA driver that comes with your video card and
  2257.                try viewing the image again.
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.                                                                             38
  2298.